home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 March / CHIP Mart 1997.iso / prg / Modemdr / MDR52FST.TXT < prev    next >
Encoding:
Text File  |  1993-06-02  |  40.4 KB  |  1,123 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.               __________________________________________________
  9.                                     T H E 
  10.                                   M O D E M
  11.                                  D O C T O R
  12.                              Version 5.2S / 5.2R
  13.                   Hank Volpe copyr. 1989,1990,1991,1992,1993
  14.                                 P.O. Box 43214
  15.                               Baltimore MD 21236      
  16.                __________________________________________________
  17.  
  18.  
  19.  
  20. Thank you for using the Modem Doctor. This file offers you a brief
  21. introduction into how the program works, and how you can use the Modem
  22. Doctor to solve your communication problems. 
  23.  
  24. Why would you need the Modem Doctor? Well, have you ever tried to install
  25. a serial card or a modem to find out that you have the IRQ lines set
  26. wrong, or the modem cable wired wrong, or some silly jumper set
  27. incorrectly? What about when you have had trouble connecting to a BBS? Is
  28. it the phone line, your setup, or your modem? Could it be the uart,
  29. settings on your serial card, or an incorrect assignment of the base port
  30. address? The Modem Doctor was written to assist you with all of these
  31. problems and some of the pitfalls involved in Personal Computer
  32. communications. 
  33.  
  34. The Modem Doctor checks every serial port chip (uart) register, checks
  35. cables and modems for proper handshaking signals, and will inform you if
  36. it runs across something that isn't set properly. Modems are also
  37. rigorously tested, including handshaking tests and modem self-connect
  38. tests which simulate an on-line connection. IRQ assignment errors, base
  39. port addressing errors, and a host of other settings are checked. The
  40. Modem Doctor also will inform you of the type of uart and modem you have
  41. installed, and will print a copy of the test results to a printer or a
  42. file.
  43.  
  44. I feel the Modem Doctor is very easy to use, in fact all you need to do is
  45. move the cursor around with your arrow keys and press return to run a
  46. feature or press the escape key to get out. You can get help at any time
  47. by pressing ALT-H. You can change the baud rate of the port you are
  48. working with at any time by pressing ALT-B. ALT-F is used to by-pass the
  49. microprocessor tests (which is discussed more in the technical reference
  50. manual). These special keys are called "Hot-Keys", and can be short-cuts
  51. at times during testing.
  52.  
  53. Remember a left or a right arrow is used to move around the main menu.
  54. Pressing enter will activate a pulldown window. Use the up or down arrows
  55. to make a selection. Press enter to start a test or escape to abort. Use
  56. any of the "hot-keys" at any time you wish. It's that simple!
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  77.  
  78.  
  79.  
  80. Starting Modem Doctor
  81. ---------------------
  82.  
  83. Here is a list of all the Modem Doctor files. Make sure you are logged
  84. onto the disk drive that has all of these files. Hard disk users should be
  85. logged into a directory that contains these files;
  86.  
  87. MDR.EXE       The Modem Doctor program executable file.
  88. MDR.CFG       A file that contains your custom color selections 
  89.                (optional, created by the user).
  90.  
  91. MDR5.DRV      A reserved file name for future external modem drivers.
  92.                (there are currently no files with this name).
  93.  
  94. MDR.DAT       A file that contains user created setup instructions for
  95.                running MDR in the /S mode (this will be explained later).
  96.  
  97. MDR.MNU       A mouse driver file that can be loaded with any Microsoft-
  98.                compatible menu load program (such as menu.com).
  99.  
  100. The program MDR.EXE can be run out of a dos path command without you being
  101. logged into the proper directory or disk, however the user selected
  102. configuration (MDR.CFG) and external driver files will not be used.
  103.  
  104. Also included with the Modem Doctor are the following text files that are
  105. a good source of technical information about testing, and the history of
  106. the Modem Doctor program. Included is an order form, for the Modem Doctor
  107. is distributed in two versions. The shareware version (5.0S) allows you to
  108. take a look at the Modem Doctor before you buy it. The Registered Version
  109. (5.0R) includes more features, comm port selections, higher baud rates and
  110. some extra test information. I feel quite certain you will agree that the
  111. Registered Version is worth the price of $19.95 (which includes shipping
  112. in the U.S.). Here is a list of these support files;
  113.  
  114.  
  115. MDR5DOC.TXT   The Technical reference Manual that explains in detail the
  116.               operation and testing of your modem and uart. 
  117.  
  118. MDR5FST.TXT   This file.
  119. MDR5ORDR.TXT  The form for you to use to order the registered version of 
  120.               the Modem Doctor.
  121.  
  122. There are four modes that the Modem Doctor operates in; normal, bios
  123. writes, setup (/s) and exchange (/x).
  124.  
  125. Normal mode is simply starting the Modem Doctor from the dos prompt by
  126. typing; MDR. 
  127.  
  128.  
  129.                                         Page 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  145.  
  146.  
  147.  
  148. Bios write mode is a feature that you might use if you have a totally
  149. incompatible display adapter. If you are visually impaired, this feature
  150. allows the text of the Modem Doctor to be echoed to your speech
  151. synthesizer system. Bios writes use the ROM-Bios of your computer instead 
  152. of working to the display adapter. This method is very slow compared to
  153. screen writes, so if you have no need for it, I would suggest that you
  154. refrain from using it. Starting the Modem Doctor in this bios write mode
  155. is done from the dos prompt by typing ; MDR /b
  156.  
  157. Setup mode is a very useful feature and gives you the ability to use the
  158. Modem Doctor every day. Setup mode is used to send setup strings
  159. (initialization strings) to your modem. In this mode, the Modem Doctor
  160. looks for a file called MDR.DAT, which you make with a simple ASCII text
  161. editor. This file contains the port, the baud rate, and the setup string
  162. you want to send to the modem. If the modem received this information
  163. properly, a message is printed to the screen, and an errorlevel of 0 is
  164. returned. If there is a problem, a message is printed and an errorlevel of
  165. 99 is returned. You can use this feature inside batch files, and these
  166. errorlevels can be used to trigger different actions. This mode is
  167. explained in great detail, with example batch files and MDR.DAT files.
  168. Starting the Modem Doctor in this setup mode is done from the dos prompt
  169. by typing ; MDR /s
  170. (Note, the setup mode is a registered feature).
  171.  
  172. New in Version 5.0, you can instruct Modem Doctor to use a comm driver 
  173. instead of its normal, uart control functions. This allows you to test the 
  174. operation of FOSSIL or other INT 14 drivers. A warning though, most comm 
  175. drivers do not allow Modem Doctor complete diagnostic testing ability. Always 
  176. make sure your modem is operating properly with Modem Doctor before you use 
  177. the FOSSIL feature. To start Modem Doctor in this mode, type MDR /i (for INT 
  178. 14 generic interface) or MDR /F (for FOSSIL support). Modem Doctor works with 
  179. both standard and extended version FOSSILS.
  180.  
  181. Version 5 of Modem Doctor includes routines that verify the actual occurance 
  182. of interrupts associated with Comm ports. In this mode, Modem Doctor will
  183. verify assignments and also report if they are associated with a mouse
  184. driver. However, self-testing of IRQ's may not be desirable in all 
  185. environments. Additionally, some environments may "freeze" when running 
  186. Modem Doctor in the IRQ test mode. Bypassing these tests is accomplished
  187. by typing ; MDR /Q at the dos prompt.
  188.  
  189. Finally, the exchange mode is used to swap Comm pointers in memory. This
  190. makes Com1 act like Com2. The main reason for this feature is so you can
  191. access a serial device that is not interrupt driven (like a printer) from
  192. some high level languages that do not allow access to Com2. Some programs
  193. do not work with two Comm ports. Running the program does not permanently
  194. alter anything, all changes can be restored by running the Modem Doctor in
  195. exchange mode again, or by warmbooting your computer. Starting the Modem
  196.  
  197.                                         Page 3
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  213.  
  214.  
  215. Doctor in this exchange mode is done from the dos prompt 
  216. by typing; MDR /x. 
  217.  
  218. You can use MDR /x to swap any of the 4 Dos comm port pointers besides the 
  219. defaults of Com1 and Com2. To do this just type the numbers of the two ports 
  220. you wish to switch..ie  MDR /x 1 4  will swap Com1 and Com4. MDR /x 2 3 will 
  221. swap Com2 and Com3. 
  222.  
  223. The following pages show you operating instructions that you receive when
  224. the Modem Doctor runs in the normal or bios write modes.
  225.  
  226. After the Modem Doctor starts, you are presented with the following
  227. screen;
  228.  
  229. ┌───────────────────────────── The Modem Doctor─────────────────────────────┐
  230. │                         Welcome to the Modem Doctor                       │
  231. └───────────────────────────────────────────────────────────────────────────┘
  232.     ╒[ Modem / Uart Hardware Detection]══════════════════════════════════╕
  233.     │ Port assignments  Base(hex)    Irq       Special Port Usage        │
  234.     │ Com port 1   [ ]     3f8        4                                  │
  235.     │ Com port 2   [ ]     2f8        3    IRQ assigned to a mouse driver│
  236.     │ Com port 3   [ ]  not found                                        │
  237.     │ Com port 4   [ ]  not found                                        │
  238.     │ Com port 5   [ ]                                                   │
  239.     │ Com port 6   [ ]                                                   │
  240.     │ Com port 7   [ ]                                                   │
  241.     │ Com port 8   [ ]                                                   │
  242.     └────────────────────────────────────────────────────────────────────┘
  243.  
  244.  ╔[  Serial Port Detection ]═══════════════════════════════════════════════╗
  245.  ║                          Serial port detection                          ║
  246.  ║                Searching for other standard active Comm ports           ║
  247.  ║                                                                         ║
  248.  ║                              Total Comm ports  =2                       ║
  249.  ║                        PRESS ANY KEY TO START TESTING                   ║
  250.  ║                                                                         ║
  251.  ║                                                                         ║
  252.  ║                                                                         ║
  253.  ══════════════════════════════════════════════════════════════════════════╝ 
  254.  
  255.  
  256.  
  257. When you start Modem Doctor for the first time, two windows are displayed on 
  258. screen. The first window, (Modem/Uart Hardware detection) gives you a 
  259. snapshot of your computer/serial port hardware. In the example above, it 
  260. found 2 Comm ports (or serial ports). The registered version also looks for 
  261. custom Comm ports (those defined by a user in a section called Log-in). 
  262.  
  263. New in version 5.0, Modem Doctor will also attempt to verify which IRQ line 
  264.  
  265.                                         Page 4
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  281.  
  282.  
  283. your comm port is using. Modem Doctor traps IRQ's 2,3,4,5,7 and then creates 
  284. a situation that should cause an interrupt. When the interrupt happens, Modem 
  285. Doctor notes the IRQ line, and displays it under the IRQ heading. If no 
  286. interrupt occurs, a 0 is displayed, which means you may have an IRQ problem, 
  287. or you need to use a FOSSIL driver for support. (See the tech reference 
  288. manual under FOSSILS and TIMER routines).
  289.  
  290. Also new in version 5.0, if a serial port is being used by a mouse driver, 
  291. Modem Doctor will flag this usage. This is done by requesting this info from 
  292. the mouse driver. Note, this feature only works with Microsoft compatible 
  293. mouse drivers.
  294.  
  295. Meanwhile, the Serial Port Detection window displays what Modem Doctor is 
  296. doing. This window maintains a dialogue between you and the program, and if 
  297. problems or special instructions need to be displayed, they are shown in this 
  298. window.
  299.  
  300. Finally, at the bottom of the screen, the copyright notice is displayed 
  301. along with either "shareware version" or your personal serial number. As a 
  302. registered user, you need your serial number for support and for 
  303. updates.After you press return, you will get the following windows on your 
  304. screen;
  305.  
  306. At this point, pressing any key will bring up a series of windows, whose 
  307. function is explained below;
  308.  
  309.  ╔[  Ports  ]═╗   ╔[  IRQ's  ]═╗    ╔[  Baud  ]══╗  
  310.  ║ Use COM 1  ║   ║ Use IRQ 2  ║    ║   300 BPS  ║  
  311.  ║ Use COM 2  ║   ║ Use IRQ 3  ║    ║  1200 BPS  ║  
  312.  ╚════════════╝   ║ Use IRQ 4  ║    ║  2400 BPS  ║  
  313.                   ║ Use IRQ 5  ║    ║  4800 BPS  ║ * 
  314.                   ║ Use IRQ 7  ║    ║  9600 BPS  ║ * 
  315.                   ╚════════════╝    ║ 19200 BPS  ║ * 
  316.                                     ║ 38400 BPS  ║ * Registered Versions
  317.                                     ║ 57600 BPS  ║ * only
  318.                                     ╚════════════╝  
  319.  
  320.  
  321. The Ports window will only display valid comm ports that you can work with. 
  322. The IRQ window automatically selects what it believes is the correct IRQ 
  323. (based on its tests), however you are free to select any IRQ line you wish. 
  324. Note- selecting the wrong IRQ is a great way to get all kinds of useless 
  325. error messages, so unless you think Modem Doctor made a mistake, use the 
  326. choice that Modem Doctor has made for you. Finally, you can pick a baud rate. 
  327. Although any computer, even an old XT will work at the highest rates, you 
  328. should realize that only fast machines can really use faster speeds. Make 
  329. sure you read the sections in the Technical Reference Manuals regarding 
  330. HISPEED modems and Interrupt Latency testing.Use the up or down arrow keys to 
  331. move the highlighted bar to your selection. If you are using a mouse, and if 
  332.  
  333.                                         Page 5
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  349.  
  350.  
  351. you have the custom Modem Doctor mouse driver loaded, , moving the mouse up 
  352. or down on your pad will do the same thing. Press return or the left mouse 
  353. key to complete your selection.
  354.  
  355. Please take care when selecting a baud rate, for you should not select 
  356. a speed faster than the modem you wish to test can support. If you are just
  357. testing the serial port without a modem, you can set the speed anywhere. In
  358. the example above, say we decided to use port 2 and use 2400 bps as the
  359. speed. 
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                                         Page 6
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  417.  
  418.  
  419.  
  420. After selecting the speed, you will get the next window;
  421.  
  422.                     ╒[  Select an Option  ]═══════════════╕
  423.                     │ Test Modem / Port 2 to 2400 BPS     │
  424.                     │ Test the Uart Hardware Only         │
  425.                     │ Don't set up modem, return to Menu  │
  426.                     └─────────────────────────────────────┘
  427.  
  428. Testing the Modem and the Port starts a series of tests which communicate
  429. to the comm port, talk to the microprocessor in the modem, run a few tests
  430. of the modem in what is called the "command mode" and then it displays of
  431. all Uart status and control and the first 16 Modem S-registers.
  432.  
  433. If you decide to test the uart only, then only the comm port section of the
  434. tests are run. You should use this test if you are just testing the comm
  435. port, or if you want to determine if the problem you are having is with the
  436. modem or the comm port.
  437.  
  438. The last option gives you the ability to change your mind in case you made
  439. an error in any of the port or baud rate choices, or simply hit the escape
  440. key to get out of this testing.
  441.  
  442. The Modem Doctor requires that you have logged in at least 1 comm port so
  443. that it can execute tests. So, if this is your first time through and you
  444. did not select, you will be "beeped" and warned to setup a port in order to
  445. access any of the other tests with the exception of auto-login and manual
  446. log-in (for registered users). If you have selected at least 1 comm port,
  447. then if you escape, the last settings you used will still be in force.
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.                                         Page 7
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  485.  
  486.  
  487.  
  488. Assuming you made a selection to start testing, the Modem Doctor now begins
  489. testing. If you selected to test the modem and the port, you will get the
  490. following displayed to you in most instances;
  491.  
  492.     ╒[ Modem / Uart System Diagnostics]══════════════════════════════════╕
  493.     │ Comm port /IRQ in use [ ] Port = 1  Address = 3F8  IRQ = 4         │
  494.     │ Int 14 interface      [ ] Inactive                                 │
  495.     │ Uart type             [ ] 16450/8250A detected                     │
  496.     │ Baud rate selected    [ ]  2400                                    │
  497.     │ Baud Rate reg test    [ ] Confirmed correct baud rate              │
  498.     │ Modem Microprocessor  [ ] Modem Microprocessor On-Line             │
  499.     │ Modem ID Type         [ ] 9600+ bps modem                          │
  500.     │ Modem Memory/Rom      [ ] Memory tests OK                          │
  501.     └────────────────────────────────────────────────────────────────────┘
  502.  
  503. ╒[ Diagnostic Dialog]═══════════════════════════════════════════════════════╕
  504. │                  Preliminary diagnostic checks of hardware                │
  505. │                  -----------------------------------------                │
  506. │                   Confirmed uart setup to proper baud rate                │
  507. │                          Testing Modem Microprocessor                     │
  508. │                          --------------------------                       │
  509. │                                                                           │
  510. │                   Modem microprocessor command bus active                 │
  511. │                Modem ID reports a 2400 bps modem installed                │
  512. │                    Modem microprocessor memory tests OK                   │
  513. │                Modem microprocessor accepts setup commands                │
  514. │                     Modem - Uart status appears correct                   │
  515. │              Press any key to see register status and diagnosis           │
  516. │                                                                           │
  517. └───────────────────────────────────────────────────────────────────────────┘
  518.  
  519.  
  520. What did the Modem Doctor do? Well, first, the Modem Doctor looked for the
  521. type of uart so that it could figure out what tests to run. It next checked
  522. a very important register in the uart that holds the baud rate divisor. It
  523. programmed it for a certain speed and then made sure that speed was indeed
  524. held properly in the uart register. These same tests are run if you had
  525. decided only to run the uart tests and not the modem tests (or visa versa).
  526.  
  527. Next, the Modem Doctor established communications with the modem
  528. microprocessor. There are dozens of ways in which this could happen, but
  529. for starters, it figures you are using an "AT" compatible instruction set.
  530. There are ways to test modems of any kind with the Modem Doctor. This
  531. information is available in the technical reference manual that comes with
  532. the Modem Doctor, so for now just assume this is a standard PC-type modem.
  533. When the Modem Doctor makes contact, it tells you that the modem is in the
  534. command mode. it then asks the modem for its ID number. Theoretically, this
  535. should indicate the maximum speed your modem can work at, however, there
  536.  
  537.                                         Page 8
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  553.  
  554.  
  555. are some manufacturers that do not follow this convention, so don't be
  556. alarmed if you have a 9600 bps modem and it says you have a 2400 bps
  557. installed, for the Modem Doctor is only working with information provided
  558. by the manufacturer and stored in its ROM. Next, a quick test of the RAM
  559. and ROM memory is run. Some modems do both, others only do one or the
  560. other. Finally, a setup string is sent to the modem, which should respond
  561. back properly. If you decided to run the uart tests alone, then none of
  562. these modem tests are run.
  563.  
  564. Finally, the screen is filled with displays that show you the internal
  565. settings of the Uart registers and the first 16 S-registers. Many modems
  566. have more than 16 S-registers, however these first 16 are the only
  567. universally agreed-upon registers. If a problem turns up, you will get a
  568. diagnostic message that points out the error gives you an idea of what the
  569. problem can be.
  570.  
  571. A normal Uart test sequence looks like this;
  572.  
  573. ╒[ Line Control Register ]══════════╕
  574. │  DLB STB STP EPS PEN STB WS1 WS0  │ * These will alternate color. Dark
  575. └───────────────────────────────────┘   for a logic low, Bright for a
  576. ╒[ Line Status Register ]═══════════╕   logic high. If all is ok
  577. │      TSE THE BI  FE  PE  OE  DR   │   you get the diagnostic window
  578. └───────────────────────────────────┘   message displayed below.
  579. ╒[ Modem Control Register ]═════════╕
  580. │              LP  OT2 OT1 RTS DTR  │
  581. └───────────────────────────────────┘ ╒[ Diagnostics ]══════════╕
  582. ╒[ Modem Status Register ]══════════╕ │    Hardware tests OK    │
  583. │  RLS RI  DSR CTS DRD TER DDR DCS  │ │Press any key to continue│
  584. └───────────────────────────────────┘ │                         │
  585. ╒[ Interrupt ID Register ]══════════╕ └─────────────────────────┘
  586. │                      ID1 ID0 ITP  │
  587. └───────────────────────────────────┘
  588. ╒[ Interrupt Enable Register ]══════╕
  589. │                  ESI ELI ETI ERI  │
  590. └───────────────────────────────────┘
  591. ╒[ Interrupt Mask Register ]════════╕
  592. │  IQ7 IQ6 IQ5 IQ4 IQ3 IQ2 IQ1 IQ0  │
  593. └───────────────────────────────────┘
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.                                         Page 9
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  621.  
  622.  
  623.  
  624. If however something is wrong, you will get this display;
  625.  
  626.  
  627. ╒[ Line Control Register ]══════════╕
  628. │  DLB STB STP EPS PEN STB WS1 WS0  │* The register name is displayed as
  629. └───────────────────────────────────┘  the first item and what was wrong.
  630. ╒[ Line Status Register ]═══════════╕
  631. │      TSE THE BI  FE  PE  OE  DR   │╒[ Diagnostics]═══════════════════════╕
  632. └───────────────────────────────────┘│ Line Control Register readings show │
  633. ╒[ Modem Control Register ]═════════╕│ that the word length selected is    │
  634. │              LP  OT2 OT1 RTS DTR  ││ incorrect or you have a parity error│
  635. └───────────────────────────────────┘│ error. WS1 and WS0 should both be   │
  636. ╒[ Modem Status Register ]══════════╕│ on indicating that 8 bit words are  │
  637. │  RLS RI  DSR CTS DRD TER DDR DCS  ││ to be used. All other readings      │
  638. └───────────────────────────────────┘│ should be low. Parity errors could  │
  639. ╒[ Interrupt ID Register ]══════════╕│ happen once but not every time. If  │
  640. │                      ID1 ID0 ITP  ││ either persists, then the Uart is   │
  641. └───────────────────────────────────┘│ defective or communications to the  │
  642. ╒[ Interrupt Enable Register ]══════╕│ Uart are suspect.                   │
  643. │                  ESI ELI ETI ERI  ││                                     │
  644. └───────────────────────────────────┘│   PRESS ANY KEY TO CONTINUE         │
  645. ╒[ Interrupt Mask Register ]════════╕│                                     │
  646. │  IQ7 IQ6 IQ5 IQ4 IQ3 IQ2 IQ1 IQ0  ││                                     │
  647. └───────────────────────────────────┘└─────────────────────────────────────┘
  648.  
  649. There are many diagnostic messages you could get, and all of these are
  650. detailed in the technical reference manual. If you are running the modem
  651. test, you will get this display plus the first 16 S-registers, however if
  652. there was an error detected, you will get the example listed above and no
  653. S-register display. The reason for this is simple, because the uart might
  654. have a problem there is no way to know if the data coming from the modem is
  655. totally correct.
  656.  
  657. After you have logged in at least 1 comm port, the Modem Doctor will enter
  658. the main menu section. Use the main menu bar by operating your left and
  659. right arrow keys. Complete a selection with the enter key, or escape with
  660. the escape key.
  661.  
  662. The menu system is very straight forward, so you will only see here a list
  663. of all the possible menus you might run into. For detailed explanations on
  664. the tests that are conducted, refer to the Modem Doctor technical reference
  665. file (MDR5DOC.TXT).
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.                                        Page 10
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  689.  
  690.  
  691.  
  692. Main Menu Bar:
  693.  
  694. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  695. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  696. └──────────────────────────────────────────────────────────────────────────┘
  697.  
  698. For example, if you wanted to display the registers again, chose the Regs
  699. selection and press return. Next you will get a pulldown of various
  700. register tests. Just use the down or up arrows to slide the bar to the
  701. selection you wish to make, and press return to activate it.
  702.  
  703. Pulldowns
  704. ------------
  705. Pulldowns are easy to use. Each pulldown system follows the same ground
  706. rules; First, you can escape any pulldown by pressing Escape, or skip to
  707. the next pulldown by using the left or right arrow keys. Second, each
  708. pulldown includes a detailed help menu that you can access by moving the
  709. sliding bar to help or by pressing the hot-key combination ALT-H. Press any
  710. key to escape help and return to your selection. As you move from pulldown
  711. to pulldown, the Modem Doctor will remember your last selection and move
  712. the sliding bar to that choice for you.
  713.  
  714. Detailed Menus and what each  does for you;
  715.  
  716.    * Select these from the Login menu
  717. ┌───────────────────────────── The Modem Doctor───────────────────────────┐
  718. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program   │  
  719. └─────────────────────────────────────────────────────────────────────────┘
  720. ╔[  Comm Port Login  ]═══════════╗
  721. ║ Let me Auto Detect COMM Ports  ║ <- Searches for all Comm ports
  722. ║ You Manually Enter COMM Ports  ║+<- You enter port addresses
  723. ║ Help with Auto login Commands  ║ <- Detailed help or ALT-H
  724. ║      Return To Main Menu       ║
  725. ╚════════════════════════════════╝    + registered version only
  726.  
  727.  
  728.            * Select these from Regs menu
  729. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  730. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  731. └──────────────────────────────────────────────────────────────────────────┘
  732.          ╔[  Register Tests  ]══════════════╗
  733.          ║ Quick Uart Register Diagnostics  ║ <- Displays all registers
  734.          ║ DTR/DSR  RTS/CTS echo test       ║ <- Tests handshake lines
  735.          ║ Dynamic  RTS/CTS handshake test  ║+<-|Handshakes under simulated
  736.          ║ Dynamic Xon/Xoff handshake test  ║+<-|on-line conditions.
  737.          ║ Display any 10 S-registers       ║ <- Display S-registers
  738.          ║ Help and Info on these tests     ║ <- Help or ALT-H
  739.          ║       Return To Main Menu        ║
  740.  
  741.                                        Page 11
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  757.  
  758.  
  759.          ╚══════════════════════════════════╝
  760.                                              + registered version only
  761.  
  762.  
  763.  
  764.                      * Select these from Carrier menu
  765. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  766. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  767. └──────────────────────────────────────────────────────────────────────────┘
  768.                    ╔[  Setup  ]═════════════╗
  769.                    ║ Run the Carrier Tests  ║ <- Simulate on-line tests
  770.                    ║ Select Modem Commands  ║ <- Pick a modem driver
  771.                    ║ Help With Carrier Test ║ <- Help
  772.                    ║  Return to Main Menu   ║
  773.                    ╚════════════════════════╝
  774.  
  775.                                 * Select from Loopback
  776. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  777. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  778. └──────────────────────────────────────────────────────────────────────────┘
  779.                    ╔[  Loopback Tests  ]═══════════╗
  780.                    ║ Analog Loopback using a PLUG  ║ +<- test Uart & Cables
  781.                    ║ Digital Loopback 8250 UARTS   ║ +<- Uart test only
  782.                    ║ Loopback Plug Technical Data  ║ +<- How to build a
  783.                    ║ Help with Loopback Tests      ║     loopback plug
  784.                    ║     Return To Main Menu       ║
  785.                    ╚═══════════════════════════════╝
  786.                                                    +registered version only
  787.  
  788.  
  789.                                          * Select from Options
  790. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  791. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  792. └──────────────────────────────────────────────────────────────────────────┘
  793.                               ╔[  User Options Selection  ]╗
  794.  A Built-in mini-terminal  -> ║ Interactive Terminal Mode  ║
  795.  Status of all tests       -> ║ View Current Statistics    ║
  796.  Reset all tests to 0      -> ║ Reset Current Statistics   ║
  797.  Send results to printer   -> ║ Print Current Statistics   ║
  798.                               ║ Help with these options    ║
  799.                               ║    Return To Main Menu     ║
  800.                               ╚════════════════════════════╝
  801.  
  802.  
  803.                                                    * Setup selections
  804. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  805. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  806. └──────────────────────────────────────────────────────────────────────────┘
  807.                                        ╔[  Setup  ]═════════════╗
  808.  
  809.                                        Page 12
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  825.  
  826.  
  827.  Pick the Comm port and Baud rate   -> ║ Setup Command Section  ║
  828.  Customize your choice of colors    -> ║ Choose System Colors   ║
  829.                                        ║  Return to Main Menu   ║
  830.                                        ╚════════════════════════╝
  831.  
  832.  
  833.  
  834.                                                             * End options
  835. ┌───────────────────────────── The Modem Doctor────────────────────────────┐
  836. │Log-in   Regs      Carrier   Loopback  Options   Setup     End Program    │
  837. └──────────────────────────────────────────────────────────────────────────┘
  838.                                                          ╔[  Exit Options]═╗
  839.                          Quit and display results     -> ║ Exit the Program║
  840.                          Don't quit, stay in program  -> ║ Don't Exit      ║
  841.                                                          ╚═════════════════╝
  842.  
  843.  
  844. If you have a mouse, you can easily construct a custom mouse driver that
  845. will replace all of your motions. The Modem Doctor does not presently
  846. contain built-in mouse support, but it will work with any program such as
  847. Microsoft's Mouse.com and Menu.com. An example driver is included with the
  848. files on disk (MDR.MNU). Basically, you use the mouse motion left to right
  849. and up and down to replace the arrow keys, a key for escape and a key for
  850. enter or return.
  851.  
  852. Test report generator:
  853.  
  854. Whenever you quit the Modem Doctor you will get a statistical summary of
  855. all the tests and results that were run. You can also access this report
  856. anytime, and print it or reset it to zero from the options menu pulldown
  857. system. The results of these tests look like this;
  858.  
  859. ----------------------------------------------------------------------------
  860. THE MODEM DOCTOR   Ver. 4.0  Copyr. 1990 by Hank Volpe has tested this modem
  861. ----------------------------------------------------------------------------
  862.  
  863.         Diagnostics were run on your modem with the following results
  864.  
  865. Results of COM2 Testing
  866.  Test Name             # of Tests      # of Char Sent    # of Errors
  867.  ---------------       ----------      --------------    -----------
  868.  CARRIER ORIGINATE         0                0                  0
  869.  CARRIER ANSWER            0                0                  0
  870.  ANALOG LOOP               0                0                  0
  871.  DIGITAL LOOP              0                0                  0
  872.  MICROPROCESSOR            0               n/a                 0
  873.  REGISTER TESTS           24               n/a                 2
  874.  INTERRUPT TESTS           1               n/a                 0
  875.  
  876.  
  877.                                        Page 13
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  893.  
  894.  
  895.                        Speeds Modem/Uart were tested at
  896.                        --------------------------------
  897.  
  898. Tested Baud Rate : 2400
  899.  
  900.  
  901.  
  902. Results will be displayed in order for each comm port you tested. If there
  903. was an error detected, this line will be highlighted on the screen. You can
  904. reset these tests at any time, print and reset, or whatever you like.
  905.  
  906.  
  907.  
  908. The Status Bar
  909. ---------------
  910.  
  911.         Com1 | 2400bps | Micro:ON | TxINT: ON | Cfg: Generic Compatible
  912.  
  913.  
  914.  
  915. The status bar is displayed at the bottom of the screen. It shows you
  916. The Port you are using and the speed your port is operating at.
  917. Additionally it shows you if the Modem Doctor has successfully communicated
  918. to the modem microprocessor. MICRO : ON means it has, MICRO : OFF means
  919. that it has not. Normally, if you run the Modem / Uart test from
  920. the setup mode, this display will say MICRO : ON. If you only ran the Uart
  921. test, then it will say MICRO : OFF. You can toggle between states using a
  922. short-cut Hot-Key ALT-F, but I wouldn't recommend it your first time out.
  923. The ALT-F really can help if you have a modem problem to force testing,
  924. which is why it was included as a feature. See the technical reference
  925. manual for a detailed description of this feature. 
  926.  
  927. TxINT :ON indicates that Modem Doctor is using "transmit interrupts" to 
  928. determine when to send characters to your uart. ALT-T toggles this feature on 
  929. or off. Older 8250 Uarts running on slow systems had serious problems using 
  930. transmit interrupts. If you have such a machine, I would recommend you turn 
  931. this feature off if you have any problems. Refer to the Technical Reference 
  932. Manual for further information. Finally, the name of the Modem Driver you are 
  933. currently using is displayed on the right. 
  934.  
  935.  
  936. Alert Bars:
  937. -----------
  938.  
  939. Alert bars are warnings that the Modem Doctor found something that it thinks
  940. should be set another way to insure good communications. The warning is
  941. displayed with a red bar and a "beep". That is called a fatal error, which
  942. means that it is doubtful that your modem or serial port will operate with
  943. these settings. Other alert bar displays that do not have a audible "beep"
  944.  
  945.                                        Page 14
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  961.  
  962.  
  963. are considered setup warnings, and are suggestions of what you should do to
  964. make your communications better.
  965.  
  966. External Modem Drivers (MDR5.DRV)
  967.  
  968. The Modem Doctor uses a software module to communicate with most brands of
  969. modems. These "modem drivers" are built into the Modem Doctor. When you
  970. start up the Modem Doctor, it will make a choice of the correct
  971. driver to use depending on what kind of modem it finds. You can always
  972. override this choice by going to the Carrier tests and selecting the
  973. pulldown "Select Modem Commands".
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.                                        Page 15
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  1029.  
  1030.  
  1031.  
  1032. To keep your registered version of Modem Doctor as state-of-the-art as
  1033. possible, Version 4.0 and higher have the ability to read external modem
  1034. driver files. Like printer drivers, these files can be loaded to extend the
  1035. ability of the Modem Doctor to communicate with any type of modem. This
  1036. means you should never need to update for the sake of incorporating a new
  1037. modem selection into the Modem Doctor. ALL FUTURE MODEM DRIVER FILES WILL BE
  1038. DISTRIBUTED FREE OF CHARGE. You can always download the latest version of 
  1039. Modem Doctor and Modem Drivers from the Modem Doctor BBS (410-256-3631).
  1040.  
  1041. Questions about the Modem Doctor
  1042. --------------------------------
  1043.  
  1044. Q: Will the Modem Doctor "fix" a problem?
  1045. A: If the problem is software based, or if it is a problem with port
  1046.    conflicts or incorrect assignments, the Modem Doctor will straightened it
  1047.    out for testing purposes only. It will advise you though what it found
  1048.    and suggest what you can do to correct the problem later. You can always
  1049.    print this information by using the Print Screen command from your
  1050.    keyboard.
  1051.  
  1052.  
  1053. Q: I start Modem Doctor, but it freezes at the main menu. What's wrong?
  1054. A: Modem Doctor 5 performs a self-test IRQ generation and verification
  1055.    routine that might not be compatible with your computer environment,
  1056.    especially if it runs with a network interface. To bypass these tests,
  1057.    run Modem Doctor with the /Q switch. In this mode, no IRQ verification
  1058.    is performed.
  1059.  
  1060. Q: I have a LCD display, and the colors the modem doctor uses do not give
  1061.    me good contrast.
  1062.  
  1063. A: Go to setup, select custom colors, and pick the shades you like, or
  1064.    better still, use monochrome shades. This information will be saved
  1065.    in a file in the same directory you are in currently for the next time
  1066.    you load the Modem Doctor.
  1067.  
  1068.  
  1069. Q: I tell the Modem Doctor to test my Modem, but it says it is not
  1070.    compatible.
  1071.  
  1072. A: This could be due to several things;
  1073.     1) You must make sure you use a baud rate equal to or lower than
  1074.        the maximum baud rate of your modem. If you try for example to talk
  1075.        to the modem at 19.2K bps but your modem is only a 2400 bps, then
  1076.        the Modem Doctor will report falsely about your modem.
  1077.  
  1078.     2) You do not have a modem attached to that port. In this case run the
  1079.        Uart diagnostics.
  1080.  
  1081.                                        Page 16
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.                 Modem Doctor 5.2 Users Guide Copyright 1993 Hank Volpe
  1097.  
  1098.  
  1099.     3) Your modem is off or disconnected.
  1100.  
  1101.  
  1102.  
  1103. Q: I would like to use a mouse, but the Modem Doctor doesn't recognize it.
  1104. A: The Modem Doctor does not have internal mouse support, but it will work
  1105.    with programs such as Microsoft's Menu.com and special mouse drivers
  1106.    that you create. A sample driver is included with the Modem Doctor.
  1107.  
  1108.  
  1109. Q: If a new modem comes on the market that is not compatible, can the Modem
  1110.    Doctor work with it?
  1111.  
  1112. A: You can use the Modem Doctor in what is called the "Dumb Modem" mode to
  1113.    test any modem than has external switches to generate carrier tests.
  1114.    Furthermore, this release of the Modem Doctor will work with externally
  1115.    created modules for incompatible modems. If a modem is manufactured at
  1116.    a later time that creates a new set of rules, these external modules
  1117.    will be distributed at no cost to all users. Also, custom modules can be
  1118.    created for any registered user for a small fee.
  1119.  
  1120.  
  1121. Q: The Analog loop tests do not run.
  1122. A: This feature only works in the registered version. If you have a     
  1123.    registered version and have a problem, you also need to have a loop-back  
  1124.    plug attached either to the back of your PC, or to the end of a cable     
  1125.    that you are testing. You can run these tests usually through most modem
  1126.    command modes, however you might get errors that are not valid. The    
  1127.    Analog loopback was meant to be a help in spotting a bad cable or
  1128.    connector.
  1129.  
  1130. Q: Do I need to worry if my modem does not pass any of the Dynamic tests?
  1131. A: Only if you have a high speed modem. Most 9600 bps modems need these
  1132.    handshaking signals to work properly, but at 2400 and lower, they are
  1133.    seldom used. If the Modem Doctor reports that all the uart handshaking
  1134.    signals are present, then all you need to do is set your modem up
  1135.    according to the manufacturers handbook. You can do this from the
  1136.    Interactive terminal mode without even exiting the Modem Doctor, and then
  1137.    use the Modem Doctor to test that your settings are correct.
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.                                        Page 17
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.